home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / wais / x / README < prev    next >
Text File  |  1995-05-09  |  3KB  |  68 lines
  1. README:    WAIS Unix X UI release 8 b5            Sun May 10 1992
  2.  Jonathan Goldman                 Thinking Machines Corp
  3. ------------------------------------------------------------------------
  4.  
  5. WARRANTY DISCLAIMER
  6.  
  7. This software was created by Thinking Machines Corporation and is
  8. distributed free of charge.  It is placed in the public domain and
  9. permission is granted to anyone to use, duplicate, modify and redistribute
  10. it provided that this notice is attached.
  11.  
  12. Thinking Machines Corporation provides absolutely NO WARRANTY OF ANY KIND
  13. with respect to this software.  The entire risk as to the quality and
  14. performance of this software is with the user.  IN NO EVENT WILL THINKING
  15. MACHINES CORPORATION BE LIABLE TO ANYONE FOR ANY DAMAGES ARISING OUT THE
  16. USE OF THIS SOFTWARE, INCLUDING, WITHOUT LIMITATION, DAMAGES RESULTING FROM
  17. LOST DATA OR LOST PROFITS, OR FOR ANY SPECIAL, INCIDENTAL OR CONSEQUENTIAL
  18. DAMAGES.
  19.  
  20. This release of the X WAIS Station provides two executables: xwais and
  21. xwaisq.  The first, xwais, is a simple shell that "wraps around" xwaisq,
  22. the real workhorse of the system.
  23.  
  24. To get an idea how to run use this application, look at the file XwaisHELP.
  25.  
  26. There are four critical resources the user can specify to change the
  27. default directories the application uses.  They are the questionDirectory,
  28. userSourceDirectory, commonSourceDirectory and documentDirectory resources.
  29. This is where the application will attempt to find the initial questions
  30. and sources, and where the application will store documents.  Set this
  31. according to your personal directories.  It is also important that the
  32. helpFile resources be set to the path where the X sources are.
  33.  
  34. The default values will probably work for most people.  The application
  35. does know how to expand ~/ (so long as the environment variable HOME is
  36. set), but does not know about other user directories.
  37.  
  38. Notes on building these applications:
  39.  
  40. This release attempts to build using an Imakefile.  If X is installed on
  41. your machine, and you have write access to the X binary and
  42. application-default directories, the X distribution should be easy to
  43. build.  Use xmkmf to create a locally consistant Makefile, then type "make
  44. install" to do it all.
  45.  
  46. If this doesn't work, you can use my old example makefile, called
  47. My-Makefile.  Use "make -f My-Makefile".  If it doesn't work "out of the
  48. box" take a look at it for some pointers on how to actually build xwais and
  49. xwaisq.  If your site does not use the "usual" directories for X
  50. (/usr/include/X, /usr/lib/X11, or /usr/local/lib) you should modify the
  51. CFLAGS and LFLAGS to point at the places your X distribution actaully uses.
  52. You might have to find a system-administrator to assist you at installing
  53. the application and its default resources (Xwais).
  54.  
  55. Take a look at the file Xwais to make sure the commonSourceDirectory and
  56. helpfile resources are the correct pathnames for you site.  I've attempted
  57. to do this automatically, but it may not always work.
  58.  
  59. Finally, I've included shell scripts in the bin directory of this
  60. distribution that will set the XUSERFILESEARCHPATH to this directory, so
  61. you need not install the app-defaults.  When you verify that everything is
  62. set correctly, you may want to do `make install` to install the binaries
  63. and app-defaults at your site.
  64.  
  65. A note about the viewers (Xwais.filters resource):  The default viewers
  66. with this release require the pbm utilities (part of contrib in the MIT X11
  67. release).
  68.